Skip to content

Conversation

@sergical
Copy link
Member

@sergical sergical commented Jan 7, 2026

Summary

Redesigns the Next.js Logs documentation with improved layout and content:

  • Split-view layout — Text explanations on left, code examples on right
  • Inlined integrations — Console, Pino, Consola, Winston with split-view
  • Sample payload — Shows all default attributes in context (replaces verbose tables)
  • Troubleshooting section — Common issues: enableLogs config, dropped logs, filtered data
  • Best practices — Wide events, business context, consistent naming

Why Next.js-specific?

Next.js requires enableLogs: true in 3 separate config files (client, server, edge), unlike most SDKs that have a single init.

Future work

This split-view layout can be applied to other SDK logs docs. The pattern established here (setup, usage, integrations, best practices, troubleshooting) can become the standard template.

🤖 Generated with Claude Code

@linear
Copy link

linear bot commented Jan 7, 2026

DEVEX-225 Logs

@vercel
Copy link

vercel bot commented Jan 7, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
develop-docs Ready Ready Preview, Comment Jan 8, 2026 2:27pm
sentry-docs Ready Ready Preview, Comment Jan 8, 2026 2:27pm

- Create dedicated Next.js logs page with full SplitLayout
- Add Best Practices section (wide events, business context, naming)
- Use table format for default attributes (easier to scan)
- Add enableLogs to Edge config in quickstart
- Create Next.js-specific setup include with all 3 runtime configs

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
@sergical sergical force-pushed the sergiydybskiy/devex-225-logs branch from 9dde7d9 to 3175e42 Compare January 7, 2026 22:31
…ctions

- Add sidebar_section: features to show under FEATURES nav
- Add new: true for sidebar NEW badge
- Remove StepComponent wrapper (sections aren't sequential steps)
- Use markdown ## for Default Attributes (shows in TOC)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Add sidebar_title: Logs to fix FEATURES section placement
- Inline all integrations content with SplitLayout
- Console, Pino, Consola, Winston each get split view treatment

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
sergical and others added 3 commits January 7, 2026 23:58
…ple payload

- Remove FeatureBadge (sidebar badge is enough)
- Inline integrations with split-view layout
- Add Upcoming Integrations section
- Replace attribute tables with annotated JSON sample
- Add Troubleshooting section (enableLogs, dropped logs, filtered data)
- Add payload_size attribute

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
Dedicated page has inline content, platform-include not needed.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
Platform-include needed for common logs page fallback.
Next.js is unique because it requires enableLogs in 3 config files.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
Copy link
Member

@chargome chargome left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good!

@sergical sergical enabled auto-merge (squash) January 8, 2026 14:17
@sergical sergical merged commit de55afd into master Jan 8, 2026
14 checks passed
@sergical sergical deleted the sergiydybskiy/devex-225-logs branch January 8, 2026 14:29
philipphofmann pushed a commit that referenced this pull request Jan 9, 2026
## Summary

Redesigns the Next.js Logs documentation with improved layout and
content:

- **Split-view layout** — Text explanations on left, code examples on
right
- **Inlined integrations** — Console, Pino, Consola, Winston with
split-view
- **Sample payload** — Shows all default attributes in context (replaces
verbose tables)
- **Troubleshooting section** — Common issues: enableLogs config,
dropped logs, filtered data
- **Best practices** — Wide events, business context, consistent naming

## Why Next.js-specific?

Next.js requires `enableLogs: true` in **3 separate config files**
(client, server, edge), unlike most SDKs that have a single init.

## Future work

This split-view layout can be applied to other SDK logs docs. The
pattern established here (setup, usage, integrations, best practices,
troubleshooting) can become the standard template.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.5 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants